home *** CD-ROM | disk | FTP | other *** search
/ Whiteline: Alpha / Whiteline Alpha.iso / tools / cpx_acc / clock / clock.man < prev    next >
Encoding:
Text File  |  1994-01-03  |  13.9 KB  |  336 lines
  1.  
  2.  CLOCK.ACC,  Version 2.0   Copyright 1989-1992 by Stefan Hintz
  3.     ist ein Uhren-Accessory. Es ist SHAREWARE.
  4.  
  5. +   CLOCK.ACC
  6.     läuft in einem rahmenlosen Fenster
  7.     und zeigt die Zeit analog als Ziffernblatt an.
  8.  
  9. +   Die Uhr läuft auch dann korrekt weiter, wenn sie teilweise von
  10.     anderen Fenstern überdeckt wird.
  11.  
  12. +   Mit der 'Help'-Taste kann man zwischen
  13.     folgenden Darstellungen umschalten:
  14.       0. analog
  15.       1. analog und digitales Datum
  16.       2. analog und digitale Uhrzeit und Datum
  17.       3. analog und digitale Uhrzeit
  18.       4. analog, digitale Uhrzeit,Datum und Weckzeit !
  19.       5. digitales Datum
  20.       6. digitale Uhrzeit und Datum
  21.       7. digitale Uhrzeit
  22.  
  23. +   Fenster bewegen:
  24.     Zum Bewegen des Fensters wird die rechte Maustaste gedrückt gehalten;
  25.     das Fenster kann so auch unter oder zwischen
  26.     andere Fenster geschoben werden.
  27.  
  28. +   Status sichern:
  29.     Wenn man 'Control-S' tippt, wird die aktuelle Position und Status in
  30.     der Datei CLOCK.INF auf dem Bootlaufwerk gemerkt.
  31.     Beim nächsten Booten wird dann die gespeicherte Position eingenommen.
  32.  
  33.     Bedeutung einer Beispiel-CLOCK.INF-Datei:
  34.  
  35.         Versionskennung     :   @(#) Clock.Info 2.0
  36.         relative X-Position :   X 10000
  37.         relative Y-Position :   Y 10000
  38.         Breite              :   W 64
  39.         Höhe                :   H 64
  40.         Status              :   S 0
  41.         Objektfarben        :   C 6,1,2,3,7,4,14,9,10,11,15,12
  42.         Auto-Open           :   O 1
  43.         3D-Darstellung      :   D 1
  44.         Sekundenzeiger      :   U 1
  45.         Weckzeit            :   A 0700
  46.  
  47. +   Fenster schließen:
  48.     Mit 'Control-U' wird das Fenster geschlossen.
  49.     Falls CLOCK als Programm gestartet wurde, wird es beendet.
  50.  
  51. +   Mit der 'Home'-Taste wird das Fenster in die rechte obere Ecke
  52.     bewegt.
  53.  
  54. +   Undo:
  55.     Mit der 'Undo'-Taste wird die in CLOCK.INF
  56.     gespeicherte Position und Größe eingenommen.
  57.  
  58. +   Insert:
  59.     Nach Drücken der 'Insert'-Taste kann man mit CLOCK
  60.     das Datum, die Uhrzeit und die Weckzeit editieren.
  61.     Die 'Return'-Taste beendet die Eingabe.
  62.     Unvollständige oder unsinnige Zeitangaben bewirken keine
  63.     Verstellung der Uhrzeit bzw. des Datums. Um die Uhrzeit zu
  64.     verstellen, müssen die Sekunden unbedingt mit angegeben werden.
  65.  
  66.     auto-open:
  67.         Das Feld "auto-open" ist mit der Maus an- und abschaltbar.
  68.         Damit läßt sich einstellen, ob sich das Uhrenfenster automatisch
  69.         in jedem GEM-Programm öffnen soll, oder nur in Programmen, die
  70.         das AV_PROTOKOLL verstehen, also z.B.: in Gemini und CAT.
  71.  
  72.     second:
  73.         Das Feld "second" ist mit der Maus an- und abschaltbar.
  74.         Damit läßt sich einstellen, ob der Sekundenzeiger mit angezeigt
  75.         werden soll.
  76.  
  77. +   Abschaltbarer Sekundenzeiger:
  78.     Mit 'Control-Z' wird der Sekundenzeiger an- oder abgeschaltet.
  79.     (siehe auch: "second")
  80.  
  81. +   Wenn das Uhren-Fenster in einem Programm geöffnet war, so wird
  82.     es nach einem Programmwechsel erneut automatisch geöffnet.
  83.     (siehe auch: "auto-open")
  84.  
  85. +   CLOCK.ACC
  86.     versucht beim automatischen Öffnen seines Fensters, dieses
  87.     Fenster als zweitoberstes zu öffnen.
  88.  
  89. +   Weckzeit:
  90.     CLOCK.ACC kann nun zu einer einstellbaren Zeit an Gemini
  91.     eine Mitteilung schicken, daß die Datei CLOCK.MUP auf dem
  92.     Bootlaufwerk ausgeführt wird.
  93.     In die Datei CLOCK.MUP sollte man die zu startenden Programme
  94.     und deren Parameter eintragen.
  95.     So kann man sich z.B. täglich wecken lassen oder eine
  96.     Mailbox automatisch anrufen.
  97.     Das funktioniert nur, wenn Gemini aktiv ist und das Uhrenfenster
  98.     geöffnet ist. Wenn man nicht möchte, daß die Weckfunktion aktiv
  99.     ist, so sollte man das Weckzeit-Eingabefeld leer lassen.
  100.     Im Zifferblatt erscheint eine kleine Markierung, wenn die Weckzeit
  101.     gültig ist.
  102.     Nach Ändern der Weckzeit sollte der aktuelle Status mit 'Control-S'
  103.     gespeichert werden, damit die neue Weckzeit bei nächsten Booten
  104.     nicht verloren geht.
  105.  
  106.     Aufbau der Kommandozeile, die an CLOCK.MUP übergeben wird:
  107.         $0  :   enthält den kompletten Namen der CLOCK.MUP-Datei
  108.         $1  :   enthält die Versionsnummer von CLOCK.ACC
  109.         $2  :   enthält den kompletten Namen der CLOCK.INF-Datei
  110.         $3  :   Vier Ziffern der Weckzeit
  111.         $4  :   Sechs Ziffern der Uhrzeit
  112.         $5  :   Acht Ziffern des Datums
  113.  
  114.     In CLOCK.MUP darf man die Dateien CLOCK.INF und CLOCK.MUP durch andere
  115.     Dateien überkopieren, um so z.B. eine neue Weckzeit und ein anderes
  116.     Weckprogramm vorgeben zu können.
  117.     Wenn CLOCK.ACC die Message VA_PROGSTART erhält, reagiert CLOCK.ACC
  118.     wie bei der 'UNDO'-Taste. Die eventuell geänderte CLOCK.INF Datei, wird
  119.     also erneut ausgewertet. Auf diesem Weg ist es z.B. möglich,
  120.     mehrere Programme zu verschiedenen Zeiten an einem einem Tag starten zu
  121.     lassen. Ebenfalls ist auf diese Weise möglich, sich je nach Tag zu
  122.     unterschiedlichen Zeiten wecken zulassen.
  123.  
  124. +   Bei der reinen Analog-Uhr-Darstellung wird der Mauszeiger nur
  125.     dann ausgeschaltet, wenn er sich innerhalb des Fensters befindet;
  126.     dadurch entfällt das störende Flackern des Mauszeigers im Sekundentakt.
  127.  
  128. +   CLOCK.ACC
  129.     läuft in allen Auflösungen aller Atari ST/TT/Falcon Modelle
  130.     mit allen Grafikkarten die GEM unterstützen.
  131.  
  132. +   CLOCK.ACC paßt die Fensterposition automatisch an die Bildschirmgröße
  133.     an; auch beim Umschalten von AutoSwitch-OverScan.
  134.  
  135. +   CLOCK.ACC
  136.     kann auch in CLOCK.APP umbenannt werden, es läuft dann als Programm.
  137.     Unter MultiGEM oder MagiX wird auch in diesem Fall das AV_PROTOKOLL
  138.     benutzt.
  139.  
  140. +   CLOCK.ACC reagiert auf die Messagenummer 0x4711
  141.        (VA_START,  wie sie z.B. von Gemini an ACC's verschickt wird,
  142.         wenn man einen Doppelklick das ein ACC-Icon anwählt)
  143.     in dem das Fenster geöffnet oder geschlossen wird.
  144.  
  145. +   CLOCK.ACC benutzt das AV_PROTOKOLL.
  146.        Gesendet werden:
  147.         AV_PROTOKOLL, AV_ACCWINDOPEN, AV_ACCWINDCLOSED, AV_SENDKEY
  148.         und AV_STARTPROG
  149.        Empfangen werden:
  150.         VA_START, VA_PROTOSTATUS, VA_PROGSTART
  151.  
  152.     Die genauere Bedeutung dieser Mitteilungen entnehme
  153.     man bitte der Gemini 1.2 - Dokumentation.
  154.     Soviel sei gesagt; das Ganze dient dazu Tastendrücke die vom CLOCK.ACC
  155.     nicht verwendet werden, an die Hauptapplikation weiter zu reichen.
  156.     Außerdem wird der Hauptapplikation mitgeteilt, ob CLOCK.ACC sein Fenster
  157.     offen hat, damit das Hauptprogramm beim Wechseln der Fenster
  158.     (in Gemini mit 'Control-W') dieses mit einbeziehen kann.
  159.  
  160. +   Clipboard:
  161.     Mit 'Control-C' wird das aktuelle Datum ins Clipboard als Datei
  162.     SCRAP.TXT geschrieben, aber nur wenn zuvor ein anderes Programm
  163.      (z.B.: Gemini, Wordplus)
  164.     das Clipboard angelegt hat. Die anderen Dateien SCRAP.* werden
  165.     dabei gelöscht.
  166.  
  167. +   Farbeinstellung:
  168.     Auf mehrfachen Wunsch eines einzelnen Herrn (JR@MS)
  169.     kann man die Farben des Ziffernblatt frei wählen.
  170.     Diese Funktion ist nur über Tastatur erreichbar.
  171.  
  172.     Hintergrundfarbe:
  173.         'Shift-Cursor-Rechts'   =   Farbindex um 1 erhöhen
  174.         'Shift-Cursor-Links'    =   Farbindex um 1 erniedrigen
  175.  
  176.     Vordergrundfarbe:
  177.         'Control-Cursor-Rechts' =   Farbindex um 1 erhöhen
  178.         'Control-Cursor-Links'  =   Farbindex um 1 erniedrigen
  179.  
  180.     Es sind insgesamt Farben für sechs Objekte einstellbar:
  181.         Zeiger,
  182.         Hintergrund,
  183.         Sekundenzeiger,
  184.         Striche, (das sind die Markierungen für 3,6,9 und 12Uhr.)
  185.         Punkte,  (das sind die Markierungen für die restlichen Stunden.)
  186.         Weckzeit-Markierung
  187.  
  188.     Mit 'Cursor-Hoch' und 'Cursor-Runter' kann man zwischen
  189.     diesen sechs Objekten wählen, um mit
  190.     'Control-Cursor-Rechts' und 'Control-Cursor-Links'
  191.     die Farbe dieser Objekte verstellen zu können.
  192.  
  193.     Farbe auf Schwarz-Weiß zurücksetzen:
  194.         'Shift-Home'
  195.  
  196.     Wenn man bestimmte Objekte (z.B.: Sekundenzeiger oder Weckzeit-Markierung)
  197.     nicht sehen möchte, so gibt man ihnen die gleiche Farbe wie dem Hintergrund.
  198.  
  199. +   3D-Darstellung:
  200.     Die 3D-Darstellung ist erst bei Grafikauflösungen mit mindestens
  201.     16 Farben möglich. Die 3D-Darstellung wird durch Licht und Schatten
  202.     an den Objekten erreicht. Daher ist bei jedem der sechs Objekte
  203.     zusätzlich eine Farbe für die beleuchtete Seite einstellbar.
  204.  
  205.     In der diese Darstellung bewirkt 'Shift-Home' ein Zurücksetzen auf
  206.     bunte Farben. Bei Verwendung der Standard-GEM-Farbpalette ergibt sich
  207.     folgendes:
  208.         Zeiger:                 Gelb,   Hellgelb
  209.         Hintergrund:            Schwarz,Dunkelgrau
  210.         Sekundenzeiger:         Rot,    Hellrot
  211.         Striche:                Grün,   Hellgrün
  212.         Punkte:                 Magenta,Hellmagenta
  213.         Weckzeit-Markierung:    Blau,   HellBlau
  214.  
  215.     Die Standard-GEM-Farbpalette für die ersten 16 Farben
  216.     sieht folgendermaßen aus:
  217.  
  218.         Farbindex:      Farbe:
  219.         0               Weiß
  220.         1               Schwarz
  221.         2               Rot
  222.         3               Grün
  223.         4               Blau
  224.         5               Cyan
  225.         6               Gelb
  226.         7               Magenta
  227.         8               Hellgrau
  228.         9               Dunkelgrau
  229.         10              Hellrot
  230.         11              Hellgrün
  231.         12              Hellblau
  232.         13              Hellcyan
  233.         14              Hellgelb
  234.         15              Hellmagenta
  235.  
  236. +   CLOCKCOL.CPX
  237.     Um einfacher die Farben von CLOCK.ACC einstellen zu können,
  238.     gibt es nun ein CPX-Modul für das modulare Kontrollfeld XCONTROL.ACC.
  239.     XCONTROL.ACC ist im Lieferumfang von allen neueren MEGA-STE
  240.     und TT-Rechnern enthalten. CLOCKCOL.CPX ist nur mit 16 Farben sinnvoll
  241.     einzusetzen. Obviously, it is silly to have a CPX which controls the
  242.     operation of a desk accessory.
  243.  
  244. +   Größenveränderung des Zifferblattes:
  245.     Bei gedrückter linken Maustaste kann die Größe des Ziffernblatt
  246.     verändert werden. Dazu klickt man entweder auf den Rand des
  247.     Fensters, um eine der vier Kanten zu verschieben
  248.     oder in eine der vier Ecken des Fensters diese zu verändern.
  249.     Wenn außer dem analogen Zifferblatt noch die digitale Zeitanzeige
  250.     aktiviert ist, kann die Breite nicht verändert werden.
  251.     Die Größe kann zwischen 16 und 80 Pixeln variiert werden.
  252.     Die Größe wird während der Veränderung in einer kleinen Box
  253.     in der Bildschirmmitte angezeigt.
  254.  
  255. +   Auf einem STE oder TT, welche über digitalen DMA-Sound verfügen,
  256.     ertönt zu jeder vollen Stunde eine kleine Kirchenglocke.
  257.     Sie läutet 1-12 mal, je nach Uhrzeit.
  258.     Zur Lautstärken-,Klangregelung nehme man das XCONTROL.ACC von Atari.
  259.     Der DMA-Sound wird nicht aktiviert, falls jemand auf die Idee
  260.     gekommen sein sollte, CLOCK.ACC ins TT-RAM zuladen.
  261.     CLOCK.ACC verträgt sich mit anderen Programmen, die gleichzeitig
  262.     den DMA-Sound benutzen, wie z.B. die MOD-File-Player "Paula" und
  263.     "JUKEBOX". CLOCK schaltet dazu den DMA vorrübergehend ab ab, um
  264.     ihn selbst auszugeben. Danach schaltet CLOCK den alten DMA-Sound
  265.     wieder ein, so daß die Musik an der gleichen Stelle weiterläuft,
  266.     wo sie unterbrochen wurde!
  267.  
  268. +   Auf Rechnern ohne DMA-Sound, wird das Stundensignal per Dosound() erzeugt.
  269.  
  270. +   Für Leute die nicht über eine batteriegepufferte System-Uhr verfügen,
  271.     (oder denen die Batterie alle geworden sind) vergleicht CLOCK.ACC
  272.     beim Lesen der CLOCK.INF-Datei das Dateidatum mit der Systemzeit.
  273.     Wenn nun das Systemdatum älter als das Dateidatum ist, wird das
  274.     Systemdatum auf das Dateidatum gesetzt. Außerdem verändert die Uhr
  275.     in diesem Fall ihr Aussehen, um den Benutzer aufzufordern die richtige
  276.     Zeit einzugeben. Mit 'Undo' kann dann wieder das eingestellte Aussehen
  277.     erreicht werden. Mit 'Control-S' kann das Dateidatum auf das
  278.     Systemdatum gesetzt werden.
  279.  
  280. +   Übersicht über die verwendeten Tasten:
  281.     Help                    Darstellung umschalten
  282.     Undo                    Einstellungen aus CLOCK.INF lesen
  283.     Insert                  Zeiteingabe
  284.     Home                    Fenster in rechte obere Ecke bewegen
  285.     Shift-Home              Farben auf Schwarzweiß zurücksetzen
  286.     Cursor-Up               Farbeinstellung
  287.     Cursor-Down               "
  288.     Shift-Cursor-Right        "
  289.     Shift-Cursor-Left         "
  290.     Control-Cursor-Right      "
  291.     Control-Cursor-Left       "
  292.     Control-S               Einstellungen in CLOCK.INF speichern
  293.     Control-C               Datum ins Clipboard schreiben
  294.     Control-U               Fenster schließen
  295.     Control-D               Umschaltung zwischen Normal- und 3D-Darstellung
  296.     Control-Z               Sekunden-Zeiger abschalten
  297.  
  298. Wichtiger Hinweis:
  299.     Ich, Stefan Hintz, übernehme keine Haftung für irgendwelche
  300.     direkten oder indirekten Schäden -- einschließlich aber nicht
  301.     beschränkt auf materielle oder finanzielle, die durch die
  302.     Benutzung dieses Programms oder die Untauglichkeit dieses Pro-
  303.     gramms für einen bestimmten Zweck entstehen.
  304.  
  305.  
  306. CLOCK.ACC darf, unter der Bedingung, daß dieser Text ebenfalls
  307. mit kopiert wird, an jeden weiter gegeben oder über Mailboxsysteme
  308. öffentlich zugänglich gemacht werden.
  309.  
  310. Wem CLOCK.ACC gefällt oder es seit mehr als einem Monat benutzt,
  311. hat die SHAREWARE-Gebühr zu bezahlen.
  312.  
  313. Änderungen an diesem Text oder am Programm selbst dürfen nicht
  314. vorgenommen werden. Wer etwas geändert haben möchte,
  315. oder weitere Anregungen hat, kann sich bei mir melden.
  316.  
  317.     Email:  Stefan_Hintz@do.maus.ruhr.de
  318.  
  319. Dieses Programm darf nicht ohne meine schriftliche Einwilligung
  320. verkauft werden - auch nicht über PD-Händler.
  321.  
  322. CLOCK.ACC ist SHAREWARE.
  323. Der SHAREWARE-Beitrag beträgt 20 DM.
  324. Wer mir 30 DM überweist, bekommt umgehend eine aktuelle Version auf
  325. einer Disk zugeschickt.
  326. Als Verwendungszweck bitte 'SHAREWARE-Beitrag CLOCK.ACC' angeben.
  327.  
  328. Kontonummer:     55 120 66
  329. Bankleitzahl:   330 500 00  Stadtsparkasse Wuppertal
  330.  
  331.     Stefan Hintz
  332.     Burggrafenstraße 2
  333.     44139 Dortmund
  334.  
  335. --
  336.